home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / time-tools / cuckoo / cuckoo.doc < prev    next >
Encoding:
Text File  |  1993-10-06  |  5.0 KB  |  103 lines
  1.                                        
  2.                                  Cuckoo V1.2
  3.                              -------------------
  4.                                        
  5.                             By Anders Melchiorsen
  6.                                  on 06-Oct-93
  7.          
  8.          
  9.          Cuckoo will play  a nice 'cuckoo'  sample if started  at ??:00  or
  10.      ??:30. This  way you  can  have your  old  grandfather clock  sort  of
  11.      emulated on your Amiga :-).
  12.          Cuckoo will read the clock and  cuckoo the right number of  times.
  13.      If Cuckoo is not started exatcly at an hour or at a half hour it  will
  14.      exit silently (only my name is printed :-). Because of this behaviour,
  15.      Cuckoo is  most useful  together  with Reminder  or a  similar  'cron'
  16.      utility (that's  a  program that  can  execute programs  at  specified
  17.      times), and therefore no icon is included.
  18.          
  19.          There isn't much to say about using Cuckoo, just start it at ??:00
  20.      or ??:30 and see (hear) how it works (you CAN, as an alternative,  set
  21.      the clock to e.g. 12:00 and then start Cuckoo within a minute -  then,
  22.      afterward, set the time back with 'SetClock LOAD').
  23.          Perhaps I should say  that Cuckoo can be  breaked by sending  it's
  24.      process a ^C. There  are several ways to do  this, the simplest is  to
  25.      press Ctrl-C when you've  started Cuckoo from the  Shell. If you  know
  26.      of, and prefer, other ways, then you're welcome to use them as well.
  27.          
  28.          Why use  Cuckoo instead  of just  a regular  sample player?  Well,
  29.      there are several reasons. Just to mention some:
  30.          
  31.          1. Cuckoo will figure out how many times to play the sample all by
  32.             itself.
  33.          2. You don't have to find the sample yourself :-).
  34.          3. Sample is  inside the  executeable. This  gives faster  loading
  35.             along with less CPU and diskdrive overhead.
  36.          4. Cuckoo can be made resident.
  37.          
  38.          I have included the source, which isn't that much of a deal anyway
  39.      (but, who knows, perhaps it was just what you needed :-). If you  want
  40.      to use a diffrent sample, you must edit the file 'Sample.a' to include
  41.      the sample you want.  I believe it  can be any length,  as long as  it
  42.      will fit in your CHIP memory (I've tested upto a 365 KB sample) -  the
  43.      only restriction I know of is that it must be a 8SVX file (is  checked
  44.      by C source) and it must contain both  a VHDR and a BODY chunk -  THIS
  45.      IS NOT CHECKED, as I didn't want to include a lot of checking. As  the
  46.      sample is contained in  the executeable it just  have to work once  to
  47.      work always, so checking would actually be pretty much waste of  code.
  48.      If it's not a 8SVX sample, Cuckoo will always quit, which makes it  an
  49.      (even more) dull program.
  50.          
  51.          This package can be  distributed as a whole  or limited to  Cuckoo
  52.      and Cuckoo.Doc, though  I would  prefer that all  files are  included.
  53.      Please don't delete Cuckoo.Doc, as  it isn't obvious what Cuckoo  does
  54.      (and, besides, I want my name to be spread :-). You're welcome to  use
  55.      the source for your own projects as much as you like (if you dare).
  56.          
  57.          And finaly: If  you like/use  this program  I would  like a  short
  58.      letter from you -  no money, just a  letter :-). Suggestions are  more
  59.      than welcome, too. You can contact me in three ways:
  60.          
  61.          Anders Melchiorsen
  62.          Gammel Skivevej 39
  63.          7870 Roslev
  64.          Denmark (yeah!)
  65.          
  66.          Phone +45 97 57 19 99
  67.          
  68.          Fido: 2:230/314.10
  69.          
  70.          
  71.          
  72.          
  73.                                    History
  74.                                   ---------
  75.          
  76.          26-Jun-93, V1.0: Initial release
  77.          
  78.          24-Jul-93, V1.1: Cuckoo now turns the low-pass filter off while
  79.                           playing the sample. Don't get scared when your
  80.                           power LED is flashing while Cuckoo is playing;
  81.                           it's only Cuckoo, not a software failure.
  82.          
  83.          03-Aug-93      : When using the Find8SVXInformation() in another
  84.                           program, I found that it was buggy. I fixed it
  85.                           and (of course) placed the fixed one in Cuckoo as
  86.                           well.
  87.          
  88.          13-Aug-93      : Cuckoo would cause a software failure if it
  89.                           couldn't allocate an audio channel. This actually
  90.                           was a bug in PlaySound.c, which I had stolen
  91.                           (morale: det betaler sig ikke at stjæle :-).
  92.          
  93.          06-Oct-93, V1.2: The return code (to Dos) was random on normal
  94.                           exit. Now only flashes the power led once (not
  95.                           once for every cuckoo). Cleaned PlaySound.c up
  96.                           (uses a proper Wait() instead of busy-loop when
  97.                           the sample was longer than 131000 bytes and some
  98.                           redundant code was removed). Added ^C check.
  99.          
  100.          
  101.  
  102.  
  103.